Programming with QuickTime VR

Link Hot Spot Atom Structure

A link hot spot atom contains specific information about a link hot spot. The structure of a link hot spot atom is defined by the VRLinkHotSpotAtom data type:



 
typedef struct VRLinkHotSpotAtom {

    UInt16                              majorVersion;

    UInt16                              minorVersion;

    UInt32                              toNodeID;

    UInt32                              fromValidFlags;

    Float32                             fromPan;

    Float32                             fromTilt;

    Float32                             fromFOV;

    FloatPoint                          fromViewCenter;

    UInt32                              toValidFlags;

    Float32                             toPan;

    Float32                             toTilt;

    Float32                             toFOV;

    FloatPoint                          toViewCenter;

    Float32                             distance;

    UInt32                              flags;

    UInt32                              reserved1;

    UInt32                              reserved2;

} VRLinkHotSpotAtom, *VRLinkHotSpotAtomPtr;

majorVersion: The major version number of the file format.
minorVersion: The minor version number of the file format.
toNodeID: The ID of the destination node (that is, the node to which this hot spot is linked).
fromValidFlags: A set of flags that indicate which source node view settings are valid. See "Link Hot Spot Valid Bits" for a description of the available flags.
fromPan: The current pan angle at the source node (that is, the node containing the hot spot).
fromTilt: The current tilt angle at the source node.
fromFOV: The current field of view at the source node.
fromViewCenter: The current view center at the source node.
toValidFlags: A set of flags that indicate which destination node view settings are valid. See "Link Hot Spot Valid Bits" for a description of the available flags.
toPan: The pan angle to use when displaying the destination node.
toTilt: The tilt angle to use when displaying the destination node.
toFOV: The field of view to use when displaying the destination node.
toViewCenter: The view center to use when displaying the destination node.
distance: The distance between the source node and the destination node.
flags: A set of link hot spot flags. Currently, this field is unused.
reserved1: Reserved. This field must be 0.
reserved2: Reserved. This field must be 0.